这是一种在 XML 文件中定义的通用形状。

res / drawable / filename.xml

文件名用作资源 ID。

指向 GradientDrawable 的资源指针。

形状可绘制对象。这必须是根元素。

属性：

xmlns:android

字符串。必备。定义 XML 命名空间，其必须是 “http://schemas.android.com/apk/res/android” 。

android:shape

关键字。定义形状的类型。有效值为：

仅当 android:shape=“ring” 如下时才使用以下属性：

android:innerRadius

尺寸。环内部（中间的孔）的半径，以尺寸值或尺寸资源表示。

android:innerRadiusRatio

浮点型。环内部的半径，以环宽度的比率表示。例如，如果 android:innerRadiusRatio=“5”，则内半径等于环宽度除以 5。此值被 android:innerRadius 覆盖。默认值为 9。

android:thickness

尺寸。环的厚度，以尺寸值或尺寸资源表示。

android:thicknessRatio

浮点型。环的厚度，表示为环宽度的比率。例如，如果 android:thicknessRatio=“2”，则厚度等于环宽度除以 2。此值被 android:innerRadius 覆盖。默认值为 3。

android:useLevel

布尔值。如果此属性用作 LevelListDrawable，则值为“true”。此属性的值通常应为“false”，否则无法显示形状。

为形状产生圆角。仅当形状为矩形时适用。

属性：

android:radius

尺寸。所有角的半径，以尺寸值或尺寸资源表示。对于每个角，这会被以下属性覆盖。

android:topLeftRadius

尺寸。左上角的半径，以尺寸值或尺寸资源表示。

android:topRightRadius

尺寸。右上角的半径，以尺寸值或尺寸资源表示。

android:bottomLeftRadius

尺寸。左下角的半径，以尺寸值或尺寸资源表示。

android:bottomRightRadius

尺寸。右下角的半径，以尺寸值或尺寸资源表示。

注：（最初）必须为每个角提供大于 1 的角半径，否则无法产生圆角。如果希望特定角不要倒圆角，解决方法是使用 android:radius 设置大于 1 的默认角半径，然后使用实际所需的值替换每个角，为不希望倒圆角的角提供零（“0dp”）。

指定形状的渐变颜色。

属性：

android:angle

整型。渐变的角度（度）。0 为从左到右，90 为从上到上。必须是 45 的倍数。默认值为 0。

android:centerX

浮点型。渐变中心的相对 X 轴位置 (0 - 1.0)。

android:centerY

浮点型。渐变中心的相对 Y 轴位置 (0 - 1.0)。

android:centerColor

颜色。起始颜色与结束颜色之间的可选颜色，以十六进制值或颜色资源表示。

android:endColor

颜色。结束颜色，表示为十六进制值或颜色资源。

android:gradientRadius

浮点型。渐变的半径。仅在 android:type=“radial” 时适用。

android:startColor

颜色。起始颜色，表示为十六进制值或颜色资源。

android:type

关键字。要应用的渐变图案的类型。有效值为：

android:useLevel

布尔值。如果此属性用作 LevelListDrawable，则值为“true”。

要应用到包含视图元素的内边距（这会填充视图内容的位置，而非形状）。

属性：

android:left

尺寸。左内边距，表示为尺寸值或尺寸资源

android:top

尺寸。上内边距，表示为尺寸值或尺寸资源

android:right

尺寸。右内边距，表示为尺寸值或尺寸资源

android:bottom

尺寸。下内边距，表示为尺寸值或尺寸资源

形状的大小。

属性：

android:height

尺寸。形状的高度，表示为尺寸值或尺寸资源

android:width

尺寸。形状的宽度，表示为尺寸值或尺寸资源

注： 默认情况下，形状根据此处定义的尺寸，按比例缩放至容器视图的大小。在 ImageView 中使用形状时，您可将 android:scaleType 设置为 “center”，从而限制缩放。

用于填充形状的纯色。

属性：

android:color

颜色。应用于形状的颜色，以十六进制值或颜色资源表示。

形状的笔划中线。

属性：

android:width

尺寸。线宽，以尺寸值或尺寸表示。

android:color

颜色。线的颜色，表示为十六进制值或颜色资源。

android:dashGap

尺寸。短划线的间距，以尺寸或资源表示。仅在设置了android:dashWidth 时有效。

android:dashWidth

尺寸。每个短划线的大小，以尺寸值或尺寸资源表示。仅在设置了 android:dashGap 时有效。

实例：链接。